home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48_2 / chasm01.sha / README < prev    next >
Text File  |  1995-03-23  |  2KB  |  60 lines

  1. /*
  2.  *    README - chasm README file
  3.  *
  4.  *    @(#)README    1.1 91/04/10
  5.  *
  6.  *    Copyright (c) 1991 Steve Scherf
  7.  *
  8.  *    Author:    Steve Scherf
  9.  *    Date:    Wed Apr 10 22:53:11 PDT 1991
  10.  *
  11.  */
  12.  
  13. Chasm v0.1
  14.  
  15. Since you're reading this, you've most likely unshar-ed the chasm package.
  16. The unpacked files should include:
  17.  
  18.     chasm.c
  19.     chasm.doc
  20.     chasm.h
  21.     grammar.y
  22.     lex.c
  23.     link.c
  24.     Makefile
  25.     README
  26.     sample.ch
  27.  
  28. Chasm is written for System V Unix, but should run under BSD and other
  29. operating systems with little or no modification. To compile, merely type
  30. "make". The result should be the successful compilation of a binary called
  31. "chasm". This program was written mostly as an exercise in learning yacc
  32. and general assembler construction, and as a result is probably a little
  33. over-complex. There are many features that are not really necessary, but
  34. are useful and might come in handy. Chasm really does make it easy to write
  35. Chip 48 programs!
  36.  
  37. At this point I have extensively tested chasm to make sure it generates the
  38. opcodes laid out in the original Chip 48 v2.25 document. Each instruction
  39. does indeed produce the proper opcode. However, I have only written a few
  40. programs with it and have not actually tested every instruction in the context
  41. of a program. Therefore, it is possible that some instructions may not work
  42. properly if the documentation is erroneous; nevertheless, I believe that chasm
  43. is fairly bug-free.
  44.  
  45. Chasm is simple to use. Simply type "chasm filename" where "filename" is
  46. a file containing chasm assembly instructions. If chasm successfully
  47. assembles the file, the result should be a file called "c.out" which contains
  48. an executable Chip 48 binary. This file can be downloaded to the HP 48
  49. via kermit (make sure the mode is set to binary).
  50.  
  51. Included is a sample chasm file called sample.ch. Try assembling and
  52. running it!
  53.  
  54. If you have any questions, comments or bugs to report, don't hesitate to send
  55. email. I can't promise that I will respond very quickly since I am often
  56. very busy, but I will try.
  57.  
  58. Steve Scherf
  59. steve@Altos.COM
  60.